home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / ifl / TIFFReadDirectory.z / TIFFReadDirectory
Encoding:
Text File  |  2002-10-03  |  11.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4. TTTTIIIIFFFFFFFFRRRReeeeaaaaddddDDDDiiiirrrreeeeccccttttoooorrrryyyy((((3333TTTT))))                IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      TIFFReadDirectory - get the contents of the next directory in an open
  10.      TIFF file
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttiiiiffffffffiiiioooo....hhhh>>>>
  14.      iiiinnnntttt TTTTIIIIFFFFFFFFRRRReeeeaaaaddddDDDDiiiirrrreeeeccccttttoooorrrryyyy((((TTTTIIIIFFFFFFFF**** ttttiiiiffff))))
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      Read the next directory in the specified file and make it the current
  18.      directory.  Applications only need to call _T_I_F_F_R_e_a_d_D_i_r_e_c_t_o_r_y to read
  19.      multiple subfiles in a single TIFF file- the first directory in a file is
  20.      automatically read when _T_I_F_F_O_p_e_n is called.
  21.  
  22. NNNNOOOOTTTTEEEESSSS
  23.      If the library is compiled with STRIPCHOP_SUPPORT enabled, then images
  24.      that have a single uncompressed strip or tile of data are automatically
  25.      treated as if they were made up of multiple strips or tiles of
  26.      approximately 8 kilobytes each.  This operation is done only in-memory;
  27.      it does not alter the contents of the file.  However, the construction of
  28.      the ``chopped strips'' is visible to the application through the number
  29.      of strips [tiles] returned by _T_I_F_F_N_u_m_b_e_r_O_f_S_t_r_i_p_s [_T_I_F_F_N_u_m_b_e_r_O_f_T_i_l_e_s].
  30.  
  31. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  32.      If the next directory was successfully read, 1 is returned.  Otherwise, 0
  33.      is returned if an error was encountered, or if there are no more
  34.      directories to be read.
  35.  
  36. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  37.      All error messages are directed to the _T_I_F_F_E_r_r_o_r(3T) routine.  All
  38.      warning messages are directed to the _T_I_F_F_W_a_r_n_i_n_g(3T) routine.
  39.  
  40.      SSSSeeeeeeeekkkk eeeerrrrrrrroooorrrr aaaacccccccceeeessssssssiiiinnnngggg TTTTIIIIFFFFFFFF ddddiiiirrrreeeeccccttttoooorrrryyyy.  An error occurred while positioning
  41.      to the location of the directory.
  42.  
  43.      WWWWrrrroooonnnngggg ddddaaaattttaaaa ttttyyyyppppeeee %%%%dddd ffffoooorrrr ffffiiiieeeelllldddd """"%%%%ssss"""".  The tag entry in the directory had an
  44.      incorrect data type.  For example, an _I_m_a_g_e_D_e_s_c_r_i_p_t_i_o_n tag with a SHORT
  45.      data type.
  46.  
  47.      TTTTIIIIFFFFFFFF ddddiiiirrrreeeeccccttttoooorrrryyyy iiiissss mmmmiiiissssssssiiiinnnngggg rrrreeeeqqqquuuuiiiirrrreeeedddd """"%%%%ssss"""" ffffiiiieeeelllldddd.  The specified tag is
  48.      required to be present by the TIFF 5.0 specification, but is missing.
  49.      The directory is (usually) unusable.
  50.  
  51.      %%%%ssss:::: RRRRaaaattttiiiioooonnnnaaaallll wwwwiiiitttthhhh zzzzeeeerrrroooo ddddeeeennnnoooommmmiiiinnnnaaaattttoooorrrr.  A directory tag has a RATIONAL value
  52.      whose denominator is zero.
  53.  
  54.      IIIInnnnccccoooorrrrrrrreeeecccctttt ccccoooouuuunnnntttt %%%%dddd ffffoooorrrr ffffiiiieeeelllldddd """"%%%%ssss"""" ((((%%%%lllluuuu,,,, eeeexxxxppppeeeeccccttttiiiinnnngggg %%%%lllluuuu))));;;; ttttaaaagggg iiiiggggnnnnoooorrrreeeedddd.  The
  55.      specified tag's count field is bad.  For example, a count other than 1
  56.      for a _S_u_b_F_i_l_e_T_y_p_e tag.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTIIIIFFFFFFFFRRRReeeeaaaaddddDDDDiiiirrrreeeeccccttttoooorrrryyyy((((3333TTTT))))                IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll
  71.  
  72.  
  73.  
  74.      CCCCaaaannnnnnnnooootttt hhhhaaaannnnddddlllleeee ddddiiiiffffffffeeeerrrreeeennnntttt ppppeeeerrrr----ssssaaaammmmpppplllleeee vvvvaaaalllluuuueeeessss ffffoooorrrr ffffiiiieeeelllldddd """"%%%%ssss"""".  The tag has
  75.      _S_a_m_p_l_e_s_P_e_r_P_i_x_e_l values and they are not all the same; e.g.
  76.      _B_i_t_s_P_e_r_S_a_m_p_l_e.  The library is unable to handle images of this sort.
  77.  
  78.      CCCCoooouuuunnnntttt mmmmiiiissssmmmmaaaattttcccchhhh ffffoooorrrr ffffiiiieeeelllldddd """"%%%%ssss"""";;;; eeeexxxxppppeeeeccccttttiiiinnnngggg %%%%dddd,,,, ggggooootttt %%%%dddd.  The count field in
  79.      a tag does not agree with the number expected by the library.  This
  80.      should never happen, so if it does, the library refuses to read the
  81.      directory.
  82.  
  83.      IIIInnnnvvvvaaaalllliiiidddd TTTTIIIIFFFFFFFF ddddiiiirrrreeeeccccttttoooorrrryyyy;;;; ttttaaaaggggssss aaaarrrreeee nnnnooootttt ssssoooorrrrtttteeeedddd iiiinnnn aaaasssscccceeeennnnddddiiiinnnngggg oooorrrrddddeeeerrrr.  The
  84.      directory tags are not properly sorted as specified in the TIFF 5.0
  85.      specification.  This error is not fatal.
  86.  
  87.      IIIIggggnnnnoooorrrriiiinnnngggg uuuunnnnkkkknnnnoooowwwwnnnn ffffiiiieeeelllldddd wwwwiiiitttthhhh ttttaaaagggg %%%%dddd ((((0000xxxx%%%%xxxx)))).  An unknown tag was
  88.      encountered in the directory; the library ignores all such tags.
  89.  
  90.      TTTTIIIIFFFFFFFF ddddiiiirrrreeeeccccttttoooorrrryyyy iiiissss mmmmiiiissssssssiiiinnnngggg rrrreeeeqqqquuuurrrreeeedddd """"IIIImmmmaaaaggggeeeeLLLLeeeennnnggggtttthhhh"""" ffffiiiieeeelllldddd.  The image
  91.      violates the specification by not having a necessary field.  There is no
  92.      way for the library to recover from this error.
  93.  
  94.      TTTTIIIIFFFFFFFF ddddiiiirrrreeeeccccttttoooorrrryyyy iiiissss mmmmiiiissssssssiiiinnnngggg rrrreeeeqqqquuuurrrreeeedddd """"PPPPllllaaaannnnaaaarrrrCCCCoooonnnnffffiiiigggg"""" ffffiiiieeeelllldddd.  The image
  95.      violates the specification by not having a necessary field.  There is no
  96.      way for the library to recover from this error.
  97.  
  98.      TTTTIIIIFFFFFFFF ddddiiiirrrreeeeccccttttoooorrrryyyy iiiissss mmmmiiiissssssssiiiinnnngggg rrrreeeeqqqquuuurrrreeeedddd """"SSSSttttrrrriiiippppOOOOffffffffsssseeeettttssss"""" ffffiiiieeeelllldddd.  The image has
  99.      multiple strips, but is missing the tag that specifies the file offset to
  100.      each strip of data.  There is no way for the library to recover from this
  101.      error.
  102.  
  103.      TTTTIIIIFFFFFFFF ddddiiiirrrreeeeccccttttoooorrrryyyy iiiissss mmmmiiiissssssssiiiinnnngggg rrrreeeeqqqquuuurrrreeeedddd """"TTTTiiiilllleeeeOOOOffffffffsssseeeettttssss"""" ffffiiiieeeelllldddd.  The image has
  104.      multiple tiles, but is missing the tag that specifies the file offset to
  105.      each tile of data.  There is no way for the library to recover from this
  106.      error.
  107.  
  108.      TTTTIIIIFFFFFFFF ddddiiiirrrreeeeccccttttoooorrrryyyy iiiissss mmmmiiiissssssssiiiinnnngggg rrrreeeeqqqquuuuiiiirrrreeeedddd """"SSSSttttrrrriiiippppBBBByyyytttteeeeCCCCoooouuuunnnnttttssss"""" ffffiiiieeeelllldddd.  The image
  109.      has multiple strips, but is missing the tag that specifies the size of
  110.      each strip of data.  There is no way for the library to recover from this
  111.      error.
  112.  
  113.      TTTTIIIIFFFFFFFF ddddiiiirrrreeeeccccttttoooorrrryyyy iiiissss mmmmiiiissssssssiiiinnnngggg rrrreeeeqqqquuuuiiiirrrreeeedddd """"SSSSttttrrrriiiippppBBBByyyytttteeeeCCCCoooouuuunnnnttttssss"""" ffffiiiieeeelllldddd,,,, ccccaaaallllccccuuuullllaaaattttiiiinnnngggg
  114.      ffffrrrroooommmm iiiimmmmaaaaggggeeeelllleeeennnnggggtttthhhh.  The image violates the specification by not having a
  115.      necessary field.  However, when the image is comprised of only one strip
  116.      or tile, the library will estimate the missing value based on the file
  117.      size.
  118.  
  119.      BBBBoooogggguuuussss """"SSSSttttrrrriiiippppBBBByyyytttteeeeCCCCoooouuuunnnnttttssss"""" ffffiiiieeeelllldddd,,,, iiiiggggnnnnoooorrrriiiinnnngggg aaaannnndddd ccccaaaallllccccuuuullllaaaattttiiiinnnngggg ffffrrrroooommmm iiiimmmmaaaaggggeeeelllleeeennnnggggtttthhhh.
  120.      Certain vendors violate the specification by writing zero for the
  121.      StripByteCounts tag when they want to leave the value unspecified.  If
  122.      the image has a single strip, the library will estimate the missing value
  123.      based on the file size.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. TTTTIIIIFFFFFFFFRRRReeeeaaaaddddDDDDiiiirrrreeeeccccttttoooorrrryyyy((((3333TTTT))))                IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll
  137.  
  138.  
  139.  
  140. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.      _l_i_b_t_i_f_f(3T), _T_I_F_F_O_p_e_n(3T), _T_I_F_F_W_r_i_t_e_D_i_r_e_c_t_o_r_y(3T), _T_I_F_F_S_e_t_D_i_r_e_c_t_o_r_y(3T),
  142.      _T_I_F_F_S_e_t_S_u_b_D_i_r_e_c_t_o_r_y(3T)
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.